home *** CD-ROM | disk | FTP | other *** search
/ Aminet 7 / Aminet 7 - August 1995.iso / Aminet / disk / cdrom / DCPlayer15.lha / DCPlayer15 / ReadMe < prev   
Encoding:
Text File  |  1995-06-04  |  8.1 KB  |  209 lines
  1. DCPlayer - another pulsating Blender Software (BS) production
  2. -------------------------------------------------------------
  3.  
  4. It's yet another music CD player. This one takes very little memory, not much
  5. CPU time, works in the background, and watches the joypad or joystick plugged
  6. into controller port 1 on the CD32 or the game port on normal Amigas.
  7.  
  8. So now you can play CDs whilst doing something else using Workbench. When you
  9. want to swap CDs or skip tracks or something like that press a button on the
  10. joypad and carry on with what you were doing before, instead of messing about
  11. shuffling through windows or screens, clicking on something, then finding
  12. your way back.
  13.  
  14. I wrote it to help me to sample CDs though. Connect a sampler from the CD32's
  15. audio output to the SX-1's parallel port, load up this, load up some sample
  16. software, and use this to skip to the right place BEFORE starting to sample.
  17. Easy, eh?
  18.  
  19. At the moment nobody's found out a way of ripping music straight from CD to
  20. memory with cd.device, so this is the easiest way (just try it with the mouse
  21. on the other CD players to see what I mean).
  22.  
  23.  
  24. So, what does it work on?
  25. -------------------------
  26.  
  27. Er, the CD32. You'll need to access the Workbench or a shell. This can be
  28. done with a keyboard or one of the many serial links that connect to the Aux
  29. port or the SX-1 or CD32x which connect to the expansion port.
  30.  
  31. It should also work on Kickstart 2 or above Amigas with CD drives, provided
  32. that you are running some kind of CD32 emulation software and you've got
  33. lowlevel.library in the LIBS: directory. Some examples...
  34.  
  35.     - An A600 or A1200 with the Archos Overdrive CD drive.
  36.     - An A600 or A1200 with the Hi-Soft Squirrel or Power CD drive
  37.       (both these drives are really the same).
  38.     - Any Amiga with Cache-CDFS and an IDE or SCSI CD drive.
  39.     - Any Amiga with Kickstart 3.1 and a SCSI-2 CD drive.
  40.  
  41. It doesn't work with the CDTV or A570 because those machines use cdtv.device
  42. and I don't have any info on that. So there.
  43.  
  44.  
  45. Installing
  46. ----------
  47.  
  48. Drag the icon to your C: drawer or some other drawer that you've got set
  49. aside for programs. That's it. Have some Battenburg cake.
  50.  
  51.  
  52. Options
  53. -------
  54.  
  55. All of the options can be used in the tooltype list (click on DCPlayer and
  56. choose Information from the Icons menu to get this) if you run it from
  57. Workbench or placed after the program name if you run it from the shell.
  58.  
  59. Read out options...
  60.  
  61. - SHOW=<type>
  62.   You get a little read out on the screen of what's happening. It's really a
  63.   sprite, so it doesn't matter if you flip screens or have an autoscrolling
  64.   Workbench screen, it always stays there.
  65.  
  66.   The types are TRACK, STARTCD, STARTTRACK, ENDTRACK, ENDCD, and CHANGE. Each
  67.   type gives you a different read out (the names are obvious enough) but you
  68.   can change it whilst DCPlayer is running with the SHUFFLE button (if you've
  69.   got a CD32 joypad).
  70.  
  71. - COLOUR1=<R><G><B>
  72.   COLOUR2=<R><G><B>
  73.   COLOUR3=<R><G><B>
  74.   The highlight, shadowed, and bright colours of the read out. Each R, G, and
  75.   B number ranges from 0 to 9 or A to F (for 10 to 15). You can't leave a
  76.   space between the numbers. If you want, you can use COLOR.
  77.  
  78. - LEFT=<number>
  79.   The distance from the left edge of the screen to the read out. 0 is the far
  80.   left and 319 is the far right (but it could be a bit more if you've got an
  81.   overscanned screen).
  82.  
  83. - TOP=<number>
  84.   The distance from the top edge of the screen to the read out. 0 is the top
  85.   and 255 (or 199 for NTSC) is the bottom edge (or a bit more for overscan).
  86.  
  87. CD options...
  88.  
  89. - EMULATION=<type>
  90.   Make buggy CD32 emulation work. See the emulation doc file for more info.
  91.  
  92. - LOOP=<type>
  93.   Start up DCPlayer in repeat play mode. The options are REPEAT and REPEAT1,
  94.   but you can change it with the LOOP button (if you've got a CD32 joypad).
  95.  
  96. - PLAY=<track>
  97.   Start DCPlayer playing a CD, if there's a CD in the drive and the track
  98.   exists. Or you can give RANDOM if you want, which starts the thing off in
  99.   random play mode.
  100.  
  101. Switches...
  102.  
  103. - CHANGE
  104.   Short for SHOW=CHANGE. Kept for compatibility with older versions. Aren't
  105.   I kind?
  106.  
  107. - DISPLAY
  108.   Short for SHOW=TRACK. Kept for com... Zzzz...
  109.  
  110. - NORESET
  111.   Turn off the reset on eject option, for anyone who booted from CD and
  112.   doesn't want the CD32 to reset as soon as the boot CD is removed. If you
  113.   want to put this program on a PD CD then it's probably a good idea to
  114.   delete the brackets either side of this option in the tooltypes list.
  115.  
  116. The defaults are no read outs, some very tasteful colours, the left edge just
  117. a little bit away from the right of the screen, the top edge just a little
  118. bit away from the bottom of the screen, no changes for buggy CD32 emulation,
  119. no repeat play, don't play any tracks, and leave the reset on eject alone.
  120.  
  121. There are problems with the read out in weird screen modes like DblPAL,
  122. DblNTSC, and Super72 (probably more). There's no way I can easily change and
  123. test the program because I use PAL High Res and a telly which tends to go a
  124. bit spastic if you chuck a weird screen mode at it. Also it doesn't help
  125. matters any that the ROM Kernal Manual examples were written in Polish by a
  126. deranged monkey using a Petite typewriter.
  127.  
  128. With the left and top edge defaults, it has a guess at where the far end of
  129. the screen is, but it goes a bit mad when you have two screens displayed at
  130. once (say when the Workbench screen is dragged down a bit). Once you've told
  131. it exactly where on the screen you'd like the display to appear, it doesn't
  132. matter anyway.
  133.  
  134.  
  135. Running
  136. -------
  137.  
  138. From the Workbench, click on the icon once to start it and again to stop it.
  139.  
  140. From the shell, type "DCPlayer" to start it and hit CTRL-C to stop it. Or
  141. you can use "Run <>NIL: DCPlayer" to start it and the same again to stop it.
  142. The "Break" command works too.
  143.  
  144. To run it all the time, drag it to your WBStartup drawer or put "Run <>NIL:
  145. DCPlayer" at the end of your User-Startup.
  146.  
  147.  
  148. Controls
  149. --------
  150.  
  151. The CD32 joypad is used in almost the same way as it is in the CD32's music
  152. CD player, but there are a few differences. The stop button really stops the
  153. CD if you press it twice. Skipping through tracks is slightly different. The
  154. play button opens or closes the drive door.
  155.  
  156. If the CD is stopped, pressing the shuffle button will start the CD playing
  157. in random play mode.
  158.  
  159. If the CD isn't stopped, the shuffle button will shuffle through the kind of
  160. read out you get - this is useful for finding the exact part of a CD you want
  161. to sample. Just for those people who've had a lobotomy the types are - the
  162. track number, the time since the start of the CD, the time since the start of
  163. the track, the time to the end of the track, the time to the end of the CD,
  164. and only display changes for a short time (say when a new track has started
  165. to play, the track number will appear for a little while then disappear).
  166.  
  167. If you don't have a CD32 joypad you can also use a Megadrive joypad, a Master
  168. System joypad, or a two button joystick instead. With these you can't eject
  169. CDs, use random play, change the display, or repeat tracks. A shocking loss
  170. as I'm sure you'll agree.
  171.  
  172. Finally if you've got an old crappy single fire button joystick you miss out
  173. on all that lot and you can't stop the CD either (but you can still pause it
  174. though).
  175.  
  176.     Function        CD32 joypad        Others
  177.     --------        -----------        ------
  178.  
  179.     Play/Pause        Select            Fire
  180.     Stop/Really stop    Stop            (2nd fire)
  181.     Search <        Reverse            Up
  182.     Search >        Forward            Down
  183.     Track <            Left            Left
  184.     Track >            Right            Right
  185.     Eject/Close        Play
  186.     Random play/Display    Shuffle
  187.     None/Repeat/Repeat 1    Loop
  188.  
  189.  
  190. Boring wibble
  191. -------------
  192.  
  193. This is copyrighted by me but freely distributible. It shouldn't be altered
  194. in any way and you should only charge for disks, postage, or packing if you
  195. charge anything.
  196.  
  197. If something goes wrong (it crashes, an android appears from a trapdoor in
  198. the floor and blows up your CD32, etc...) then I can't be held responsible
  199. for the mess - you use this program at your own risk. After all, it's free -
  200. what more do you want?
  201.  
  202. And it can't be used as part of anything that's sold for profit without my
  203. say so, although the chances of that are fairly remote, I think. Oh, that
  204. means cover CDs and disks on those glossy magazines as well.
  205.  
  206. My Email address is dan@blender.demon.co.uk, if you spot a bug or something.
  207.  
  208. Dan.
  209.